home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / gnus.info-2.z / gnus.info-2
Encoding:
GNU Info File  |  1998-05-21  |  48.9 KB  |  1,491 lines
  1. This is Info file ../info/gnus.info, produced by Makeinfo version 1.68
  2. from the input file gnus.texi.
  3.  
  4.    This file documents Gnus, the GNU Emacs newsreader.
  5.  
  6.    Copyright (C) 1995,96 Free Software Foundation, Inc.
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided also
  14. that the entire resulting derived work is distributed under the terms
  15. of a permission notice identical to this one.
  16.  
  17.    Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions.
  20.  
  21. 
  22. File: gnus.info,  Node: Group Parameters,  Next: Listing Groups,  Prev: Foreign Groups,  Up: The Group Buffer
  23.  
  24. Group Parameters
  25. ================
  26.  
  27.    The group parameters store information local to a particular group:
  28.  
  29. `to-address'
  30.      If the group parameter list contains an element that looks like
  31.      `(to-address .  "some@where.com")', that address will be used by
  32.      the backend when doing followups and posts.  This is primarily
  33.      useful in mail groups that represent closed mailing lists--mailing
  34.      lists where it's expected that everybody that writes to the
  35.      mailing list is subscribed to it.  Since using this parameter
  36.      ensures that the mail only goes to the mailing list itself, it
  37.      means that members won't receive two copies of your followups.
  38.  
  39.      Using `to-address' will actually work whether the group is foreign
  40.      or not.  Let's say there's a group on the server that is called
  41.      `fa.4ad-l'.  This is a real newsgroup, but the server has gotten
  42.      the articles from a mail-to-news gateway.  Posting directly to this
  43.      group is therefore impossible--you have to send mail to the mailing
  44.      list address instead.
  45.  
  46. `to-list'
  47.      If the group parameter list has an element that looks like
  48.      `(to-list . "some@where.com")', that address will be used when
  49.      doing a `a' in that group.  It is totally ignored when doing a
  50.      followup--except that if it is present in a news group, you'll get
  51.      mail group semantics when doing `f'.
  52.  
  53.      If you do an `a' command in a mail group and you don't have a
  54.      `to-list' group parameter, one will be added automatically upon
  55.      sending the message.
  56.  
  57. `visible'
  58.      If the group parameter list has the element `(visible . t)', that
  59.      group will always be visible in the Group buffer, regardless of
  60.      whether it has any unread articles.
  61.  
  62. `broken-reply-to'
  63.      Elements like `(broken-reply-to . t)' signals that `Reply-To'
  64.      headers in this group are to be ignored.  This can be useful if
  65.      you're reading a mailing list group where the listserv has inserted
  66.      `Reply-To' headers that point back to the listserv itself.  This is
  67.      broken behavior.  So there!
  68.  
  69. `to-group'
  70.      Elements like `(to-group . "some.group.name")' means that all
  71.      posts in that group will be sent to `some.group.name'.
  72.  
  73. `newsgroup'
  74.      If this symbol is present in the group parameter list, Gnus will
  75.      treat all responses as if they were responses to news articles.
  76.      This can be useful if you have a mail group that's really a mirror
  77.      of a news group.
  78.  
  79. `gcc-self'
  80.      If this symbol is present in the group parameter list and set to
  81.      `t', newly composed messages will be `Gcc''d to the current group.
  82.      If it is present and set to `none', no `Gcc:' header will be
  83.      generated, if it is present and a string, this string will be
  84.      inserted literally as a `gcc' header (this symbol takes precedence
  85.      over any default `Gcc' rules as described later).
  86.  
  87. `auto-expire'
  88.      If the group parameter has an element that looks like `(auto-expire
  89.      . t)', all articles read will be marked as expirable.  For an
  90.      alternative approach, *note Expiring Mail::..
  91.  
  92. `total-expire'
  93.      If the group parameter has an element that looks like
  94.      `(total-expire . t)', all read articles will be put through the
  95.      expiry process, even if they are not marked as expirable.  Use with
  96.      caution.  Unread, ticked and dormant articles are not eligible for
  97.      expiry.
  98.  
  99. `expiry-wait'
  100.      If the group parameter has an element that looks like `(expiry-wait
  101.      . 10)', this value will override any `nnmail-expiry-wait' and
  102.      `nnmail-expiry-wait-function' when expiring expirable messages.
  103.      The value can either be a number of days (not necessarily an
  104.      integer) or the symbols `never' or `immediate'.
  105.  
  106. `score-file'
  107.      Elements that look like `(score-file . "file")' will make `file'
  108.      into the current score file for the group in question.  This means
  109.      that all score commands you issue will end up in that file.
  110.  
  111. `adapt-file'
  112.      Elements that look like `(adapt-file . "file")' will make `file'
  113.      into the current adaptive score file for the group in question.
  114.      All adaptive score entries will be put into this file.
  115.  
  116. `admin-address'
  117.      When unsubscribing from a mailing list you should never send the
  118.      unsubscription notice to the mailing list itself.  Instead, you'd
  119.      send messages to the administrative address.  This parameter
  120.      allows you to put the admin address somewhere convenient.
  121.  
  122. `display'
  123.      Elements that look like `(display . MODE)' say which articles to
  124.      display on entering the group.  Legal values are:
  125.  
  126.     `all'
  127.           Display all articles, both read and unread.
  128.  
  129.     `default'
  130.           Display the default visible articles, which normally includes
  131.           unread and ticked articles.
  132.  
  133. `comment'
  134.      Elements that look like `(comment . "This is a comment")' are
  135.      arbitrary comments on the group.  They are currently ignored by
  136.      Gnus, but provide a place for you to store information on
  137.      particular groups.
  138.  
  139. `(VARIABLE FORM)'
  140.      You can use the group parameters to set variables local to the
  141.      group you are entering.  If you want to turn threading off in
  142.      `news.answers', you could put `(gnus-show-threads nil)' in the
  143.      group parameters of that group.  `gnus-show-threads' will be made
  144.      into a local variable in the summary buffer you enter, and the
  145.      form `nil' will be `eval'ed there.
  146.  
  147.      This can also be used as a group-specific hook function, if you'd
  148.      like.  If you want to hear a beep when you enter a group, you
  149.      could put something like `(dummy-variable (ding))' in the
  150.      parameters of that group.  `dummy-variable' will be set to the
  151.      result of the `(ding)' form, but who cares?
  152.  
  153.    Use the `G p' command to edit group parameters of a group.
  154.  
  155.    *note Topic Parameters::..
  156.  
  157.    Here's an example group parameter list:
  158.  
  159.      ((to-address . "ding@gnus.org")
  160.       (auto-expiry . t))
  161.  
  162. 
  163. File: gnus.info,  Node: Listing Groups,  Next: Sorting Groups,  Prev: Group Parameters,  Up: The Group Buffer
  164.  
  165. Listing Groups
  166. ==============
  167.  
  168.    These commands all list various slices of the groups available.
  169.  
  170. `l'
  171. `A s'
  172.      List all groups that have unread articles
  173.      (`gnus-group-list-groups').  If the numeric prefix is used, this
  174.      command will list only groups of level ARG and lower.  By default,
  175.      it only lists groups of level five (i. e.,
  176.      `gnus-group-default-list-level') or lower (i.e., just subscribed
  177.      groups).
  178.  
  179. `L'
  180. `A u'
  181.      List all groups, whether they have unread articles or not
  182.      (`gnus-group-list-all-groups').  If the numeric prefix is used,
  183.      this command will list only groups of level ARG and lower.  By
  184.      default, it lists groups of level seven or lower (i.e., just
  185.      subscribed and unsubscribed groups).
  186.  
  187. `A l'
  188.      List all unread groups on a specific level
  189.      (`gnus-group-list-level').  If given a prefix, also list the groups
  190.      with no unread articles.
  191.  
  192. `A k'
  193.      List all killed groups (`gnus-group-list-killed').  If given a
  194.      prefix argument, really list all groups that are available, but
  195.      aren't currently (un)subscribed.  This could entail reading the
  196.      active file from the server.
  197.  
  198. `A z'
  199.      List all zombie groups (`gnus-group-list-zombies').
  200.  
  201. `A m'
  202.      List all unread, subscribed groups with names that match a regexp
  203.      (`gnus-group-list-matching').
  204.  
  205. `A M'
  206.      List groups that match a regexp (`gnus-group-list-all-matching').
  207.  
  208. `A A'
  209.      List absolutely all groups in the active file(s) of the server(s)
  210.      you are connected to (`gnus-group-list-active').  This might very
  211.      well take quite a while.  It might actually be a better idea to do
  212.      a `A M' to list all matching, and just give `.' as the thing to
  213.      match on.  Also note that this command may list groups that don't
  214.      exist (yet)--these will be listed as if they were killed groups.
  215.      Take the output with some grains of salt.
  216.  
  217. `A a'
  218.      List all groups that have names that match a regexp
  219.      (`gnus-group-apropos').
  220.  
  221. `A d'
  222.      List all groups that have names or descriptions that match a regexp
  223.      (`gnus-group-description-apropos').
  224.  
  225.    Groups that match the `gnus-permanently-visible-groups' regexp will
  226. always be shown, whether they have unread articles or not.  You can also
  227. add the `visible' element to the group parameters in question to get
  228. the same effect.
  229.  
  230.    Groups that have just ticked articles in it are normally listed in
  231. the group buffer.  If `gnus-list-groups-with-ticked-articles' is `nil',
  232. these groups will be treated just like totally empty groups.  It is `t'
  233. by default.
  234.  
  235. 
  236. File: gnus.info,  Node: Sorting Groups,  Next: Group Maintenance,  Prev: Listing Groups,  Up: The Group Buffer
  237.  
  238. Sorting Groups
  239. ==============
  240.  
  241.    The `C-c C-s' (`gnus-group-sort-groups') command sorts the group
  242. buffer according to the function(s) given by the
  243. `gnus-group-sort-function' variable.  Available sorting functions
  244. include:
  245.  
  246. `gnus-group-sort-by-alphabet'
  247.      Sort the group names alphabetically.  This is the default.
  248.  
  249. `gnus-group-sort-by-real-name'
  250.      Sort the group alphabetically on the real (unprefixed) group names.
  251.  
  252. `gnus-group-sort-by-level'
  253.      Sort by group level.
  254.  
  255. `gnus-group-sort-by-score'
  256.      Sort by group score.
  257.  
  258. `gnus-group-sort-by-rank'
  259.      Sort by group score and then the group level.  The level and the
  260.      score are, when taken together, the group's "rank".
  261.  
  262. `gnus-group-sort-by-unread'
  263.      Sort by number of unread articles.
  264.  
  265. `gnus-group-sort-by-method'
  266.      Sort alphabetically on the select method.
  267.  
  268.    `gnus-group-sort-function' can also be a list of sorting functions.
  269. In that case, the most significant sort key function must be the last
  270. one.
  271.  
  272.    There are also a number of commands for sorting directly according to
  273. some sorting criteria:
  274.  
  275. `G S a'
  276.      Sort the group buffer alphabetically by group name
  277.      (`gnus-group-sort-groups-by-alphabet').
  278.  
  279. `G S u'
  280.      Sort the group buffer by the number of unread articles
  281.      (`gnus-group-sort-groups-by-unread').
  282.  
  283. `G S l'
  284.      Sort the group buffer by group level
  285.      (`gnus-group-sort-groups-by-level').
  286.  
  287. `G S v'
  288.      Sort the group buffer by group score
  289.      (`gnus-group-sort-groups-by-score').
  290.  
  291. `G S r'
  292.      Sort the group buffer by group rank
  293.      (`gnus-group-sort-groups-by-rank').
  294.  
  295. `G S m'
  296.      Sort the group buffer alphabetically by backend name
  297.      (`gnus-group-sort-groups-by-method').
  298.  
  299.    When given a prefix, all these commands will sort in reverse order.
  300.  
  301.    You can also sort a subset of the groups:
  302.  
  303. `G P a'
  304.      Sort the process/prefixed groups in the group buffer
  305.      alphabetically by group name
  306.      (`gnus-group-sort-selected-groups-by-alphabet').
  307.  
  308. `G P u'
  309.      Sort the process/prefixed groups in the group buffer by the number
  310.      of unread articles (`gnus-group-sort-selected-groups-by-unread').
  311.  
  312. `G P l'
  313.      Sort the process/prefixed groups in the group buffer by group level
  314.      (`gnus-group-sort-selected-groups-by-level').
  315.  
  316. `G P v'
  317.      Sort the process/prefixed groups in the group buffer by group score
  318.      (`gnus-group-sort-selected-groups-by-score').
  319.  
  320. `G P r'
  321.      Sort the process/prefixed groups in the group buffer by group rank
  322.      (`gnus-group-sort-selected-groups-by-rank').
  323.  
  324. `G P m'
  325.      Sort the process/prefixed groups in the group buffer
  326.      alphabetically by backend name
  327.      (`gnus-group-sort-selected-groups-by-method').
  328.  
  329. 
  330. File: gnus.info,  Node: Group Maintenance,  Next: Browse Foreign Server,  Prev: Sorting Groups,  Up: The Group Buffer
  331.  
  332. Group Maintenance
  333. =================
  334.  
  335. `b'
  336.      Find bogus groups and delete them
  337.      (`gnus-group-check-bogus-groups').
  338.  
  339. `F'
  340.      Find new groups and process them (`gnus-group-find-new-groups').
  341.      If given a prefix, use the `ask-server' method to query the server
  342.      for new groups.
  343.  
  344. `C-c C-x'
  345.      Run all expirable articles in the current group through the expiry
  346.      process (if any) (`gnus-group-expire-articles').
  347.  
  348. `C-c M-C-x'
  349.      Run all articles in all groups through the expiry process
  350.      (`gnus-group-expire-all-groups').
  351.  
  352. 
  353. File: gnus.info,  Node: Browse Foreign Server,  Next: Exiting Gnus,  Prev: Group Maintenance,  Up: The Group Buffer
  354.  
  355. Browse Foreign Server
  356. =====================
  357.  
  358. `B'
  359.      You will be queried for a select method and a server name.  Gnus
  360.      will then attempt to contact this server and let you browse the
  361.      groups there (`gnus-group-browse-foreign-server').
  362.  
  363.    A new buffer with a list of available groups will appear.  This
  364. buffer will use the `gnus-browse-mode'.  This buffer looks a bit (well,
  365. a lot) like a normal group buffer.
  366.  
  367.    Here's a list of keystrokes available in the browse mode:
  368.  
  369. `n'
  370.      Go to the next group (`gnus-group-next-group').
  371.  
  372. `p'
  373.      Go to the previous group (`gnus-group-prev-group').
  374.  
  375. `SPACE'
  376.      Enter the current group and display the first article
  377.      (`gnus-browse-read-group').
  378.  
  379. `RET'
  380.      Enter the current group (`gnus-browse-select-group').
  381.  
  382. `u'
  383.      Unsubscribe to the current group, or, as will be the case here,
  384.      subscribe to it (`gnus-browse-unsubscribe-current-group').
  385.  
  386. `l'
  387. `q'
  388.      Exit browse mode (`gnus-browse-exit').
  389.  
  390. `?'
  391.      Describe browse mode briefly (well, there's not much to describe,
  392.      is there) (`gnus-browse-describe-briefly').
  393.  
  394. 
  395. File: gnus.info,  Node: Exiting Gnus,  Next: Group Topics,  Prev: Browse Foreign Server,  Up: The Group Buffer
  396.  
  397. Exiting Gnus
  398. ============
  399.  
  400.    Yes, Gnus is ex(c)iting.
  401.  
  402. `z'
  403.      Suspend Gnus (`gnus-group-suspend').  This doesn't really exit
  404.      Gnus, but it kills all buffers except the Group buffer.  I'm not
  405.      sure why this is a gain, but then who am I to judge?
  406.  
  407. `q'
  408.      Quit Gnus (`gnus-group-exit').
  409.  
  410. `Q'
  411.      Quit Gnus without saving the `.newsrc' files (`gnus-group-quit').
  412.      The dribble file will be saved, though (*note Auto Save::.).
  413.  
  414.    `gnus-suspend-gnus-hook' is called when you suspend Gnus and
  415. `gnus-exit-gnus-hook' is called when you quit Gnus, while
  416. `gnus-after-exiting-gnus-hook' is called as the final item when exiting
  417. Gnus.
  418.  
  419.    If you wish to completely unload Gnus and all its adherents, you can
  420. use the `gnus-unload' command.  This command is also very handy when
  421. trying to customize meta-variables.
  422.  
  423.    Note:
  424.  
  425.      Miss Lisa Cannifax, while sitting in English class, felt her feet
  426.      go numbly heavy and herself fall into a hazy trance as the boy
  427.      sitting behind her drew repeated lines with his pencil across the
  428.      back of her plastic chair.
  429.  
  430. 
  431. File: gnus.info,  Node: Group Topics,  Next: Misc Group Stuff,  Prev: Exiting Gnus,  Up: The Group Buffer
  432.  
  433. Group Topics
  434. ============
  435.  
  436.    If you read lots and lots of groups, it might be convenient to group
  437. them hierarchically according to topics.  You put your Emacs groups over
  438. here, your sex groups over there, and the rest (what, two groups or so?)
  439. you put in some misc section that you never bother with anyway.  You can
  440. even group the Emacs sex groups as a sub-topic to either the Emacs
  441. groups or the sex groups--or both!  Go wild!
  442.  
  443.    Here's an example:
  444.  
  445.      Gnus
  446.        Emacs -- I wuw it!
  447.           3: comp.emacs
  448.           2: alt.religion.emacs
  449.          Naughty Emacs
  450.           452: alt.sex.emacs
  451.             0: comp.talk.emacs.recovery
  452.        Misc
  453.           8: comp.binaries.fractals
  454.          13: comp.sources.unix
  455.  
  456.    To get this *fab* functionality you simply turn on (ooh!) the
  457. `gnus-topic' minor mode--type `t' in the group buffer.  (This is a
  458. toggling command.)
  459.  
  460.    Go ahead, just try it.  I'll still be here when you get back.  La de
  461. dum...  Nice tune, that...  la la la...  What, you're back? Yes, and now
  462. press `l'.  There.  All your groups are now listed under `misc'.
  463. Doesn't that make you feel all warm and fuzzy?  Hot and bothered?
  464.  
  465.    If you want this permanently enabled, you should add that minor mode
  466. to the hook for the group mode:
  467.  
  468.      (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
  469.  
  470. * Menu:
  471.  
  472. * Topic Variables::    How to customize the topics the Lisp Way.
  473. * Topic Commands::     Interactive E-Z commands.
  474. * Topic Sorting::      Sorting each topic individually.
  475. * Topic Topology::     A map of the world.
  476. * Topic Parameters::   Parameters that apply to all groups in a topic.
  477.  
  478. 
  479. File: gnus.info,  Node: Topic Variables,  Next: Topic Commands,  Up: Group Topics
  480.  
  481. Topic Variables
  482. ---------------
  483.  
  484.    Now, if you select a topic, it will fold/unfold that topic, which is
  485. really neat, I think.
  486.  
  487.    The topic lines themselves are created according to the
  488. `gnus-topic-line-format' variable (*note Formatting Variables::.).
  489. Legal elements are:
  490.  
  491. `i'
  492.      Indentation.
  493.  
  494. `n'
  495.      Topic name.
  496.  
  497. `v'
  498.      Visibility.
  499.  
  500. `l'
  501.      Level.
  502.  
  503. `g'
  504.      Number of groups in the topic.
  505.  
  506. `a'
  507.      Number of unread articles in the topic.
  508.  
  509. `A'
  510.      Number of unread articles in the topic and all its subtopics.
  511.  
  512.    Each sub-topic (and the groups in the sub-topics) will be indented
  513. with `gnus-topic-indent-level' times the topic level number of spaces.
  514. The default is 2.
  515.  
  516.    `gnus-topic-mode-hook' is called in topic minor mode buffers.
  517.  
  518.    The `gnus-topic-display-empty-topics' says whether to display even
  519. topics that have no unread articles in them.  The default is `t'.
  520.  
  521. 
  522. File: gnus.info,  Node: Topic Commands,  Next: Topic Sorting,  Prev: Topic Variables,  Up: Group Topics
  523.  
  524. Topic Commands
  525. --------------
  526.  
  527.    When the topic minor mode is turned on, a new `T' submap will be
  528. available.  In addition, a few of the standard keys change their
  529. definitions slightly.
  530.  
  531. `T n'
  532.      Prompt for a new topic name and create it
  533.      (`gnus-topic-create-topic').
  534.  
  535. `T m'
  536.      Move the current group to some other topic
  537.      (`gnus-topic-move-group').  This command uses the process/prefix
  538.      convention (*note Process/Prefix::.).
  539.  
  540. `T c'
  541.      Copy the current group to some other topic
  542.      (`gnus-topic-copy-group').  This command uses the process/prefix
  543.      convention (*note Process/Prefix::.).
  544.  
  545. `T D'
  546.      Remove a group from the current topic (`gnus-topic-remove-group').
  547.      This command uses the process/prefix convention (*note
  548.      Process/Prefix::.).
  549.  
  550. `T M'
  551.      Move all groups that match some regular expression to a topic
  552.      (`gnus-topic-move-matching').
  553.  
  554. `T C'
  555.      Copy all groups that match some regular expression to a topic
  556.      (`gnus-topic-copy-matching').
  557.  
  558. `T h'
  559.      Toggle hiding empty topics
  560.      (`gnus-topic-toggle-display-empty-topics').
  561.  
  562. `T #'
  563.      Mark all groups in the current topic with the process mark
  564.      (`gnus-topic-mark-topic').
  565.  
  566. `T M-#'
  567.      Remove the process mark from all groups in the current topic
  568.      (`gnus-topic-unmark-topic').
  569.  
  570. `RET'
  571. `SPACE'
  572.      Either select a group or fold a topic (`gnus-topic-select-group').
  573.      When you perform this command on a group, you'll enter the group,
  574.      as usual.  When done on a topic line, the topic will be folded (if
  575.      it was visible) or unfolded (if it was folded already).  So it's
  576.      basically a toggling command on topics.  In addition, if you give
  577.      a numerical prefix, group on that level (and lower) will be
  578.      displayed.
  579.  
  580. `T TAB'
  581.      "Indent" the current topic so that it becomes a sub-topic of the
  582.      previous topic (`gnus-topic-indent').  If given a prefix,
  583.      "un-indent" the topic instead.
  584.  
  585. `C-k'
  586.      Kill a group or topic (`gnus-topic-kill-group').  All groups in the
  587.      topic will be removed along with the topic.
  588.  
  589. `C-y'
  590.      Yank the previously killed group or topic
  591.      (`gnus-topic-yank-group').  Note that all topics will be yanked
  592.      before all groups.
  593.  
  594. `T r'
  595.      Rename a topic (`gnus-topic-rename').
  596.  
  597. `T DEL'
  598.      Delete an empty topic (`gnus-topic-delete').
  599.  
  600. `A T'
  601.      List all groups that Gnus knows about in a topics-ified way
  602.      (`gnus-topic-list-active').
  603.  
  604. `G p'
  605.      Edit the topic parameters (`gnus-topic-edit-parameters').  *Note
  606.      Topic Parameters::.
  607.  
  608. 
  609. File: gnus.info,  Node: Topic Sorting,  Next: Topic Topology,  Prev: Topic Commands,  Up: Group Topics
  610.  
  611. Topic Sorting
  612. -------------
  613.  
  614.    You can sort the groups in each topic individually with the following
  615. commands:
  616.  
  617. `T S a'
  618.      Sort the current topic alphabetically by group name
  619.      (`gnus-topic-sort-groups-by-alphabet').
  620.  
  621. `T S u'
  622.      Sort the current topic by the number of unread articles
  623.      (`gnus-topic-sort-groups-by-unread').
  624.  
  625. `T S l'
  626.      Sort the current topic by group level
  627.      (`gnus-topic-sort-groups-by-level').
  628.  
  629. `T S v'
  630.      Sort the current topic by group score
  631.      (`gnus-topic-sort-groups-by-score').
  632.  
  633. `T S r'
  634.      Sort the current topic by group rank
  635.      (`gnus-topic-sort-groups-by-rank').
  636.  
  637. `T S m'
  638.      Sort the current topic alphabetically by backend name
  639.      (`gnus-topic-sort-groups-by-method').
  640.  
  641.    *Note Sorting Groups:: for more information about group sorting.
  642.  
  643. 
  644. File: gnus.info,  Node: Topic Topology,  Next: Topic Parameters,  Prev: Topic Sorting,  Up: Group Topics
  645.  
  646. Topic Topology
  647. --------------
  648.  
  649.    So, let's have a look at an example group buffer:
  650.  
  651.      Gnus
  652.        Emacs -- I wuw it!
  653.           3: comp.emacs
  654.           2: alt.religion.emacs
  655.          Naughty Emacs
  656.           452: alt.sex.emacs
  657.             0: comp.talk.emacs.recovery
  658.        Misc
  659.           8: comp.binaries.fractals
  660.          13: comp.sources.unix
  661.  
  662.    So, here we have one top-level topic (`Gnus'), two topics under
  663. that, and one sub-topic under one of the sub-topics.  (There is always
  664. just one (1) top-level topic).  This topology can be expressed as
  665. follows:
  666.  
  667.      (("Gnus" visible)
  668.       (("Emacs -- I wuw it!" visible)
  669.        (("Naughty Emacs" visible)))
  670.       (("Misc" visible)))
  671.  
  672.    This is in fact how the variable `gnus-topic-topology' would look
  673. for the display above.  That variable is saved in the `.newsrc.eld'
  674. file, and shouldn't be messed with manually--unless you really want to.
  675. Since this variable is read from the `.newsrc.eld' file, setting it in
  676. any other startup files will have no effect.
  677.  
  678.    This topology shows what topics are sub-topics of what topics
  679. (right), and which topics are visible.  Two settings are currently
  680. allowed--`visible' and `invisible'.
  681.  
  682. 
  683. File: gnus.info,  Node: Topic Parameters,  Prev: Topic Topology,  Up: Group Topics
  684.  
  685. Topic Parameters
  686. ----------------
  687.  
  688.    All groups in a topic will inherit group parameters from the parent
  689. (and ancestor) topic parameters.  All legal group parameters are legal
  690. topic parameters (*note Group Parameters::.).
  691.  
  692.    Group parameters (of course) override topic parameters, and topic
  693. parameters in sub-topics override topic parameters in super-topics.  You
  694. know.  Normal inheritance rules.  ("Rules" is here a noun, not a verb,
  695. although you may feel free to disagree with me here.)
  696.  
  697.      Gnus
  698.        Emacs
  699.           3: comp.emacs
  700.           2: alt.religion.emacs
  701.         452: alt.sex.emacs
  702.          Relief
  703.           452: alt.sex.emacs
  704.             0: comp.talk.emacs.recovery
  705.        Misc
  706.           8: comp.binaries.fractals
  707.          13: comp.sources.unix
  708.         452: alt.sex.emacs
  709.  
  710.    The `Emacs' topic has the topic parameter `(score-file .
  711. "emacs.SCORE")'; the `Relief' topic has the topic parameter
  712. `(score-file . "relief.SCORE")'; and the `Misc' topic has the topic
  713. parameter `(score-file . "emacs.SCORE")'.  In addition,
  714. `alt.religion.emacs' has the group parameter `(score-file .
  715. "religion.SCORE")'.
  716.  
  717.    Now, when you enter `alt.sex.emacs' in the `Relief' topic, you will
  718. get the `relief.SCORE' home score file.  If you enter the same group in
  719. the `Emacs' topic, you'll get the `emacs.SCORE' home score file.  If
  720. you enter the group `alt.religion.emacs', you'll get the
  721. `religion.SCORE' home score file.
  722.  
  723.    This seems rather simple and self-evident, doesn't it?  Well, yes.
  724. But there are some problems, especially with the `total-expiry'
  725. parameter.  Say you have a mail group in two topics; one with
  726. `total-expiry' and one without.  What happens when you do `M-x
  727. gnus-expire-all-expirable-groups'?  Gnus has no way of telling which one
  728. of these topics you mean to expire articles from, so anything may
  729. happen.  In fact, I hereby declare that it is "undefined" what happens.
  730. You just have to be careful if you do stuff like that.
  731.  
  732. 
  733. File: gnus.info,  Node: Misc Group Stuff,  Prev: Group Topics,  Up: The Group Buffer
  734.  
  735. Misc Group Stuff
  736. ================
  737.  
  738. * Menu:
  739.  
  740. * Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
  741. * Group Information::     Information and help on groups and Gnus.
  742. * Group Timestamp::       Making Gnus keep track of when you last read a group.
  743. * File Commands::         Reading and writing the Gnus files.
  744.  
  745. `^'
  746.      Enter the server buffer (`gnus-group-enter-server-mode').  *Note
  747.      The Server Buffer::.
  748.  
  749. `a'
  750.      Post an article to a group (`gnus-group-post-news').  The current
  751.      group name will be used as the default.
  752.  
  753. `m'
  754.      Mail a message somewhere (`gnus-group-mail').
  755.  
  756.    Variables for the group buffer:
  757.  
  758. `gnus-group-mode-hook'
  759.      is called after the group buffer has been created.
  760.  
  761. `gnus-group-prepare-hook'
  762.      is called after the group buffer is generated.  It may be used to
  763.      modify the buffer in some strange, unnatural way.
  764.  
  765. `gnus-permanently-visible-groups'
  766.      Groups matching this regexp will always be listed in the group
  767.      buffer, whether they are empty or not.
  768.  
  769. 
  770. File: gnus.info,  Node: Scanning New Messages,  Next: Group Information,  Up: Misc Group Stuff
  771.  
  772. Scanning New Messages
  773. ---------------------
  774.  
  775. `g'
  776.      Check the server(s) for new articles.  If the numerical prefix is
  777.      used, this command will check only groups of level ARG and lower
  778.      (`gnus-group-get-new-news').  If given a non-numerical prefix, this
  779.      command will force a total re-reading of the active file(s) from
  780.      the backend(s).
  781.  
  782. `M-g'
  783.      Check whether new articles have arrived in the current group
  784.      (`gnus-group-get-new-news-this-group').
  785.      `gnus-goto-next-group-when-activating' says whether this command is
  786.      to move point to the next group or not.  It is `t' by default.
  787.  
  788. `C-c M-g'
  789.      Activate absolutely all groups (`gnus-activate-all-groups').
  790.  
  791. `R'
  792.      Restart Gnus (`gnus-group-restart').  This saves the `.newsrc'
  793.      file(s), closes the connection to all servers, clears up all
  794.      run-time Gnus variables, and then starts Gnus all over again.
  795.  
  796.    `gnus-get-new-news-hook' is run just before checking for new news.
  797.  
  798.    `gnus-after-getting-new-news-hook' is run after checking for new
  799. news.
  800.  
  801. 
  802. File: gnus.info,  Node: Group Information,  Next: Group Timestamp,  Prev: Scanning New Messages,  Up: Misc Group Stuff
  803.  
  804. Group Information
  805. -----------------
  806.  
  807. `H f'
  808.      Try to fetch the FAQ for the current group
  809.      (`gnus-group-fetch-faq').  Gnus will try to get the FAQ from
  810.      `gnus-group-faq-directory', which is usually a directory on a
  811.      remote machine.  This variable can also be a list of directories.
  812.      In that case, giving a prefix to this command will allow you to
  813.      choose between the various sites.  `ange-ftp' (or `efs') will be
  814.      used for fetching the file.
  815.  
  816.      If fetching from the first site is unsuccessful, Gnus will attempt
  817.      to go through `gnus-group-faq-directory' and try to open them one
  818.      by one.
  819.  
  820. `H d'
  821. `C-c C-d'
  822.      Describe the current group (`gnus-group-describe-group').  If given
  823.      a prefix, force Gnus to re-read the description from the server.
  824.  
  825. `M-d'
  826.      Describe all groups (`gnus-group-describe-all-groups').  If given a
  827.      prefix, force Gnus to re-read the description file from the server.
  828.  
  829. `H v'
  830. `V'
  831.      Display current Gnus version numbers (`gnus-version').
  832.  
  833. `?'
  834.      Give a very short help message (`gnus-group-describe-briefly').
  835.  
  836. `C-c C-i'
  837.      Go to the Gnus info node (`gnus-info-find-node').
  838.  
  839. 
  840. File: gnus.info,  Node: Group Timestamp,  Next: File Commands,  Prev: Group Information,  Up: Misc Group Stuff
  841.  
  842. Group Timestamp
  843. ---------------
  844.  
  845.    It can be convenient to let Gnus keep track of when you last read a
  846. group.  To set the ball rolling, you should add
  847. `gnus-group-set-timestamp' to `gnus-select-group-hook':
  848.  
  849.      (add-hook 'gnus-select-group-hook 'gnus-group-set-timestamp)
  850.  
  851.    After doing this, each time you enter a group, it'll be recorded.
  852.  
  853.    This information can be displayed in various ways--the easiest is to
  854. use the `%d' spec in the group line format:
  855.  
  856.      (setq gnus-group-line-format
  857.            "%M\%S\%p\%P\%5y: %(%-40,40g%) %d\n")
  858.  
  859.    This will result in lines looking like:
  860.  
  861.      *        0: mail.ding                                19961002T012943
  862.               0: custom                                   19961002T012713
  863.  
  864.    As you can see, the date is displayed in compact ISO 8601 format.
  865. This may be a bit too much, so to just display the date, you could say
  866. something like:
  867.  
  868.      (setq gnus-group-line-format
  869.            "%M\%S\%p\%P\%5y: %(%-40,40g%) %6,6~(cut 2)d\n")
  870.  
  871. 
  872. File: gnus.info,  Node: File Commands,  Prev: Group Timestamp,  Up: Misc Group Stuff
  873.  
  874. File Commands
  875. -------------
  876.  
  877. `r'
  878.      Re-read the init file (`gnus-init-file', which defaults to
  879.      `~/.gnus') (`gnus-group-read-init-file').
  880.  
  881. `s'
  882.      Save the `.newsrc.eld' file (and `.newsrc' if wanted)
  883.      (`gnus-group-save-newsrc').  If given a prefix, force saving the
  884.      file(s) whether Gnus thinks it is necessary or not.
  885.  
  886. 
  887. File: gnus.info,  Node: The Summary Buffer,  Next: The Article Buffer,  Prev: The Group Buffer,  Up: Top
  888.  
  889. The Summary Buffer
  890. ******************
  891.  
  892.    A line for each article is displayed in the summary buffer.  You can
  893. move around, read articles, post articles and reply to articles.
  894.  
  895.    The most common way to a summary buffer is to select a group from the
  896. group buffer (*note Selecting a Group::.).
  897.  
  898.    You can have as many summary buffers open as you wish.
  899.  
  900. * Menu:
  901.  
  902. * Summary Buffer Format::       Deciding how the summary buffer is to look.
  903. * Summary Maneuvering::         Moving around the summary buffer.
  904. * Choosing Articles::           Reading articles.
  905. * Paging the Article::          Scrolling the current article.
  906. * Reply Followup and Post::     Posting articles.
  907. * Canceling and Superseding::   "Whoops, I shouldn't have called him that."
  908. * Marking Articles::            Marking articles as read, expirable, etc.
  909. * Limiting::                    You can limit the summary buffer.
  910. * Threading::                   How threads are made.
  911. * Sorting::                     How articles and threads are sorted.
  912. * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
  913. * Article Caching::             You may store articles in a cache.
  914. * Persistent Articles::         Making articles expiry-resistant.
  915. * Article Backlog::             Having already read articles hang around.
  916. * Saving Articles::             Ways of customizing article saving.
  917. * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
  918. * Article Treatment::           The article buffer can be mangled at will.
  919. * Article Commands::            Doing various things with the article buffer.
  920. * Summary Sorting::             Sorting the summary buffer in various ways.
  921. * Finding the Parent::          No child support? Get the parent.
  922. * Alternative Approaches::      Reading using non-default summaries.
  923. * Tree Display::                A more visual display of threads.
  924. * Mail Group Commands::         Some commands can only be used in mail groups.
  925. * Various Summary Stuff::       What didn't fit anywhere else.
  926. * Exiting the Summary Buffer::  Returning to the Group buffer.
  927. * Crosspost Handling::          How crossposted articles are dealt with.
  928. * Duplicate Suppression::       An alternative when crosspost handling fails.
  929.  
  930. 
  931. File: gnus.info,  Node: Summary Buffer Format,  Next: Summary Maneuvering,  Up: The Summary Buffer
  932.  
  933. Summary Buffer Format
  934. =====================
  935.  
  936. * Menu:
  937.  
  938. * Summary Buffer Lines::     You can specify how summary lines should look.
  939. * Summary Buffer Mode Line:: You can say how the mode line should look.
  940. * Summary Highlighting::     Making the summary buffer all pretty and nice.
  941.  
  942.    Gnus will use the value of the `gnus-extract-address-components'
  943. variable as a function for getting the name and address parts of a
  944. `From' header.  Two pre-defined functions exist:
  945. `gnus-extract-address-components', which is the default, quite fast,
  946. and too simplistic solution; and `mail-extract-address-components',
  947. which works very nicely, but is slower.  The default function will
  948. return the wrong answer in 5% of the cases.  If this is unacceptable to
  949. you, use the other function instead.
  950.  
  951.    `gnus-summary-same-subject' is a string indicating that the current
  952. article has the same subject as the previous.  This string will be used
  953. with those specs that require it.  The default is `'.
  954.  
  955. 
  956. File: gnus.info,  Node: Summary Buffer Lines,  Next: Summary Buffer Mode Line,  Up: Summary Buffer Format
  957.  
  958. Summary Buffer Lines
  959. --------------------
  960.  
  961.    You can change the format of the lines in the summary buffer by
  962. changing the `gnus-summary-line-format' variable.  It works along the
  963. same lines as a normal `format' string, with some extensions (*note
  964. Formatting Variables::.).
  965.  
  966.    The default string is `%U%R%z%I%(%[%4L: %-20,20n%]%) %s\n'.
  967.  
  968.    The following format specification characters are understood:
  969.  
  970. `N'
  971.      Article number.
  972.  
  973. `S'
  974.      Subject string.
  975.  
  976. `s'
  977.      Subject if the article is the root or the previous article had a
  978.      different subject, `gnus-summary-same-subject' otherwise.
  979.      (`gnus-summary-same-subject' defaults to `'.)
  980.  
  981. `F'
  982.      Full `From' header.
  983.  
  984. `n'
  985.      The name (from the `From' header).
  986.  
  987. `a'
  988.      The name (from the `From' header).  This differs from the `n' spec
  989.      in that it uses the function designated by the
  990.      `gnus-extract-address-components' variable, which is slower, but
  991.      may be more thorough.
  992.  
  993. `A'
  994.      The address (from the `From' header).  This works the same way as
  995.      the `a' spec.
  996.  
  997. `L'
  998.      Number of lines in the article.
  999.  
  1000. `c'
  1001.      Number of characters in the article.
  1002.  
  1003. `I'
  1004.      Indentation based on thread level (*note Customizing Threading::.).
  1005.  
  1006. `T'
  1007.      Nothing if the article is a root and lots of spaces if it isn't (it
  1008.      pushes everything after it off the screen).
  1009.  
  1010. `['
  1011.      Opening bracket, which is normally `[', but can also be `<' for
  1012.      adopted articles (*note Customizing Threading::.).
  1013.  
  1014. `]'
  1015.      Closing bracket, which is normally `]', but can also be `>' for
  1016.      adopted articles.
  1017.  
  1018. `>'
  1019.      One space for each thread level.
  1020.  
  1021. `<'
  1022.      Twenty minus thread level spaces.
  1023.  
  1024. `U'
  1025.      Unread.
  1026.  
  1027. `R'
  1028.      Replied.
  1029.  
  1030. `i'
  1031.      Score as a number.
  1032.  
  1033. `z'
  1034.      Zcore, `+' if above the default level and `-' if below the default
  1035.      level.  If the difference between `gnus-summary-default-level' and
  1036.      the score is less than `gnus-summary-zcore-fuzz', this spec will
  1037.      not be used.
  1038.  
  1039. `V'
  1040.      Total thread score.
  1041.  
  1042. `x'
  1043.      `Xref'.
  1044.  
  1045. `D'
  1046.      `Date'.
  1047.  
  1048. `d'
  1049.      The `Date' in `DD-MMM' format.
  1050.  
  1051. `o'
  1052.      The `Date' in YYYYMMDD`T'HHMMSS format.
  1053.  
  1054. `M'
  1055.      `Message-ID'.
  1056.  
  1057. `r'
  1058.      `References'.
  1059.  
  1060. `t'
  1061.      Number of articles in the current sub-thread.  Using this spec
  1062.      will slow down summary buffer generation somewhat.
  1063.  
  1064. `e'
  1065.      An `=' (`gnus-not-empty-thread-mark') will be displayed if the
  1066.      article has any children.
  1067.  
  1068. `P'
  1069.      The line number.
  1070.  
  1071. `u'
  1072.      User defined specifier.  The next character in the format string
  1073.      should be a letter.  Gnus will call the function
  1074.      `gnus-user-format-function-'`X', where `X' is the letter following
  1075.      `%u'.  The function will be passed the current header as argument.
  1076.      The function should return a string, which will be inserted into
  1077.      the summary just like information from any other summary specifier.
  1078.  
  1079.    The `%U' (status), `%R' (replied) and `%z' (zcore) specs have to be
  1080. handled with care.  For reasons of efficiency, Gnus will compute what
  1081. column these characters will end up in, and "hard-code" that.  This
  1082. means that it is illegal to have these specs after a variable-length
  1083. spec.  Well, you might not be arrested, but your summary buffer will
  1084. look strange, which is bad enough.
  1085.  
  1086.    The smart choice is to have these specs as far to the left as
  1087. possible.  (Isn't that the case with everything, though?  But I
  1088. digress.)
  1089.  
  1090.    This restriction may disappear in later versions of Gnus.
  1091.  
  1092. 
  1093. File: gnus.info,  Node: Summary Buffer Mode Line,  Next: Summary Highlighting,  Prev: Summary Buffer Lines,  Up: Summary Buffer Format
  1094.  
  1095. Summary Buffer Mode Line
  1096. ------------------------
  1097.  
  1098.    You can also change the format of the summary mode bar.  Set
  1099. `gnus-summary-mode-line-format' to whatever you like.  The default is
  1100. `Gnus: %%b [%A] %Z'.
  1101.  
  1102.    Here are the elements you can play with:
  1103.  
  1104. `G'
  1105.      Group name.
  1106.  
  1107. `p'
  1108.      Unprefixed group name.
  1109.  
  1110. `A'
  1111.      Current article number.
  1112.  
  1113. `V'
  1114.      Gnus version.
  1115.  
  1116. `U'
  1117.      Number of unread articles in this group.
  1118.  
  1119. `e'
  1120.      Number of unselected articles in this group.
  1121.  
  1122. `Z'
  1123.      A string with the number of unread and unselected articles
  1124.      represented either as `<%U(+%e) more>' if there are both unread
  1125.      and unselected articles, and just as `<%U more>' if there are just
  1126.      unread articles and no unselected ones.
  1127.  
  1128. `g'
  1129.      Shortish group name.  For instance, `rec.arts.anime' will be
  1130.      shortened to `r.a.anime'.
  1131.  
  1132. `S'
  1133.      Subject of the current article.
  1134.  
  1135. `u'
  1136.      User-defined spec.
  1137.  
  1138. `s'
  1139.      Name of the current score file.
  1140.  
  1141. `d'
  1142.      Number of dormant articles.
  1143.  
  1144. `t'
  1145.      Number of ticked articles.
  1146.  
  1147. `r'
  1148.      Number of articles that have been marked as read in this session.
  1149.  
  1150. `E'
  1151.      Number of articles expunged by the score files.
  1152.  
  1153. 
  1154. File: gnus.info,  Node: Summary Highlighting,  Prev: Summary Buffer Mode Line,  Up: Summary Buffer Format
  1155.  
  1156. Summary Highlighting
  1157. --------------------
  1158.  
  1159. `gnus-visual-mark-article-hook'
  1160.      This hook is run after selecting an article.  It is meant to be
  1161.      used for highlighting the article in some way.  It is not run if
  1162.      `gnus-visual' is `nil'.
  1163.  
  1164. `gnus-summary-update-hook'
  1165.      This hook is called when a summary line is changed.  It is not run
  1166.      if `gnus-visual' is `nil'.
  1167.  
  1168. `gnus-summary-selected-face'
  1169.      This is the face (or "font" as some people call it) used to
  1170.      highlight the current article in the summary buffer.
  1171.  
  1172. `gnus-summary-highlight'
  1173.      Summary lines are highlighted according to this variable, which is
  1174.      a list where the elements are of the format (FORM . FACE).  If you
  1175.      would, for instance, like ticked articles to be italic and
  1176.      high-scored articles to be bold, you could set this variable to
  1177.      something like
  1178.           (((eq mark gnus-ticked-mark) . italic)
  1179.            ((> score default) . bold))
  1180.      As you may have guessed, if FORM returns a non-`nil' value, FACE
  1181.      will be applied to the line.
  1182.  
  1183. 
  1184. File: gnus.info,  Node: Summary Maneuvering,  Next: Choosing Articles,  Prev: Summary Buffer Format,  Up: The Summary Buffer
  1185.  
  1186. Summary Maneuvering
  1187. ===================
  1188.  
  1189.    All the straight movement commands understand the numeric prefix and
  1190. behave pretty much as you'd expect.
  1191.  
  1192.    None of these commands select articles.
  1193.  
  1194. `G M-n'
  1195. `M-n'
  1196.      Go to the next summary line of an unread article
  1197.      (`gnus-summary-next-unread-subject').
  1198.  
  1199. `G M-p'
  1200. `M-p'
  1201.      Go to the previous summary line of an unread article
  1202.      (`gnus-summary-prev-unread-subject').
  1203.  
  1204. `G j'
  1205. `j'
  1206.      Ask for an article number and then go to that article
  1207.      (`gnus-summary-goto-article').
  1208.  
  1209. `G g'
  1210.      Ask for an article number and then go to the summary line of that
  1211.      article without displaying the article
  1212.      (`gnus-summary-goto-subject').
  1213.  
  1214.    If Gnus asks you to press a key to confirm going to the next group,
  1215. you can use the `C-n' and `C-p' keys to move around the group buffer,
  1216. searching for the next group to read without actually returning to the
  1217. group buffer.
  1218.  
  1219.    Variables related to summary movement:
  1220.  
  1221. `gnus-auto-select-next'
  1222.      If you issue one of the movement commands (like `n') and there are
  1223.      no more unread articles after the current one, Gnus will offer to
  1224.      go to the next group.  If this variable is `t' and the next group
  1225.      is empty, Gnus will exit summary mode and return to the group
  1226.      buffer.  If this variable is neither `t' nor `nil', Gnus will
  1227.      select the next group, no matter whether it has any unread
  1228.      articles or not.  As a special case, if this variable is
  1229.      `quietly', Gnus will select the next group without asking for
  1230.      confirmation.  If this variable is `almost-quietly', the same will
  1231.      happen only if you are located on the last article in the group.
  1232.      Finally, if this variable is `slightly-quietly', the `Z n' command
  1233.      will go to the next group without confirmation.  Also *note Group
  1234.      Levels::..
  1235.  
  1236. `gnus-auto-select-same'
  1237.      If non-`nil', all the movement commands will try to go to the next
  1238.      article with the same subject as the current.  ("Same" here might
  1239.      mean "roughly equal".  See `gnus-summary-gather-subject-limit' for
  1240.      details (*note Customizing Threading::.).)  This variable is not
  1241.      particularly useful if you use a threaded display.
  1242.  
  1243. `gnus-summary-check-current'
  1244.      If non-`nil', all the "unread" movement commands will not proceed
  1245.      to the next (or previous) article if the current article is unread.
  1246.      Instead, they will choose the current article.
  1247.  
  1248. `gnus-auto-center-summary'
  1249.      If non-`nil', Gnus will keep the point in the summary buffer
  1250.      centered at all times.  This makes things quite tidy, but if you
  1251.      have a slow network connection, or simply do not like this
  1252.      un-Emacsism, you can set this variable to `nil' to get the normal
  1253.      Emacs scrolling action.  This will also inhibit horizontal
  1254.      re-centering of the summary buffer, which might make it more
  1255.      inconvenient to read extremely long threads.
  1256.  
  1257. 
  1258. File: gnus.info,  Node: Choosing Articles,  Next: Paging the Article,  Prev: Summary Maneuvering,  Up: The Summary Buffer
  1259.  
  1260. Choosing Articles
  1261. =================
  1262.  
  1263. * Menu:
  1264.  
  1265. * Choosing Commands::        Commands for choosing articles.
  1266. * Choosing Variables::       Variables that influence these commands.
  1267.  
  1268. 
  1269. File: gnus.info,  Node: Choosing Commands,  Next: Choosing Variables,  Up: Choosing Articles
  1270.  
  1271. Choosing Commands
  1272. -----------------
  1273.  
  1274.    None of the following movement commands understand the numeric
  1275. prefix, and they all select and display an article.
  1276.  
  1277. `SPACE'
  1278.      Select the current article, or, if that one's read already, the
  1279.      next unread article (`gnus-summary-next-page').
  1280.  
  1281. `G n'
  1282. `n'
  1283.      Go to next unread article (`gnus-summary-next-unread-article').
  1284.  
  1285. `G p'
  1286. `p'
  1287.      Go to previous unread article (`gnus-summary-prev-unread-article').
  1288.  
  1289. `G N'
  1290. `N'
  1291.      Go to the next article (`gnus-summary-next-article').
  1292.  
  1293. `G P'
  1294. `P'
  1295.      Go to the previous article (`gnus-summary-prev-article').
  1296.  
  1297. `G C-n'
  1298.      Go to the next article with the same subject
  1299.      (`gnus-summary-next-same-subject').
  1300.  
  1301. `G C-p'
  1302.      Go to the previous article with the same subject
  1303.      (`gnus-summary-prev-same-subject').
  1304.  
  1305. `G f'
  1306. `.'
  1307.      Go to the first unread article
  1308.      (`gnus-summary-first-unread-article').
  1309.  
  1310. `G b'
  1311. `,'
  1312.      Go to the article with the highest score
  1313.      (`gnus-summary-best-unread-article').
  1314.  
  1315. `G l'
  1316. `l'
  1317.      Go to the previous article read (`gnus-summary-goto-last-article').
  1318.  
  1319. `G p'
  1320.      Pop an article off the summary history and go to this article
  1321.      (`gnus-summary-pop-article').  This command differs from the
  1322.      command above in that you can pop as many previous articles off the
  1323.      history as you like.
  1324.  
  1325. 
  1326. File: gnus.info,  Node: Choosing Variables,  Prev: Choosing Commands,  Up: Choosing Articles
  1327.  
  1328. Choosing Variables
  1329. ------------------
  1330.  
  1331.    Some variables relevant for moving and selecting articles:
  1332.  
  1333. `gnus-auto-extend-newsgroup'
  1334.      All the movement commands will try to go to the previous (or next)
  1335.      article, even if that article isn't displayed in the Summary
  1336.      buffer if this variable is non-`nil'.  Gnus will then fetch the
  1337.      article from the server and display it in the article buffer.
  1338.  
  1339. `gnus-select-article-hook'
  1340.      This hook is called whenever an article is selected.  By default it
  1341.      exposes any threads hidden under the selected article.
  1342.  
  1343. `gnus-mark-article-hook'
  1344.      This hook is called whenever an article is selected.  It is
  1345.      intended to be used for marking articles as read.  The default
  1346.      value is `gnus-summary-mark-read-and-unread-as-read', and will
  1347.      change the mark of almost any article you read to
  1348.      `gnus-unread-mark'.  The only articles not affected by this
  1349.      function are ticked, dormant, and expirable articles.  If you'd
  1350.      instead like to just have unread articles marked as read, you can
  1351.      use `gnus-summary-mark-unread-as-read' instead.  It will leave
  1352.      marks like `gnus-low-score-mark', `gnus-del-mark' (and so on)
  1353.      alone.
  1354.  
  1355. 
  1356. File: gnus.info,  Node: Paging the Article,  Next: Reply Followup and Post,  Prev: Choosing Articles,  Up: The Summary Buffer
  1357.  
  1358. Scrolling the Article
  1359. =====================
  1360.  
  1361. `SPACE'
  1362.      Pressing `SPACE' will scroll the current article forward one page,
  1363.      or, if you have come to the end of the current article, will
  1364.      choose the next article (`gnus-summary-next-page').
  1365.  
  1366. `DEL'
  1367.      Scroll the current article back one page
  1368.      (`gnus-summary-prev-page').
  1369.  
  1370. `RET'
  1371.      Scroll the current article one line forward
  1372.      (`gnus-summary-scroll-up').
  1373.  
  1374. `A g'
  1375. `g'
  1376.      (Re)fetch the current article (`gnus-summary-show-article').  If
  1377.      given a prefix, fetch the current article, but don't run any of the
  1378.      article treatment functions.  This will give you a "raw" article,
  1379.      just the way it came from the server.
  1380.  
  1381. `A <'
  1382. `<'
  1383.      Scroll to the beginning of the article
  1384.      (`gnus-summary-beginning-of-article').
  1385.  
  1386. `A >'
  1387. `>'
  1388.      Scroll to the end of the article (`gnus-summary-end-of-article').
  1389.  
  1390. `A s'
  1391. `s'
  1392.      Perform an isearch in the article buffer
  1393.      (`gnus-summary-isearch-article').
  1394.  
  1395. 
  1396. File: gnus.info,  Node: Reply Followup and Post,  Next: Canceling and Superseding,  Prev: Paging the Article,  Up: The Summary Buffer
  1397.  
  1398. Reply, Followup and Post
  1399. ========================
  1400.  
  1401. * Menu:
  1402.  
  1403. * Summary Mail Commands::            Sending mail.
  1404. * Summary Post Commands::            Sending news.
  1405.  
  1406. 
  1407. File: gnus.info,  Node: Summary Mail Commands,  Next: Summary Post Commands,  Up: Reply Followup and Post
  1408.  
  1409. Summary Mail Commands
  1410. ---------------------
  1411.  
  1412.    Commands for composing a mail message:
  1413.  
  1414. `S r'
  1415. `r'
  1416.      Mail a reply to the author of the current article
  1417.      (`gnus-summary-reply').
  1418.  
  1419. `S R'
  1420. `R'
  1421.      Mail a reply to the author of the current article and include the
  1422.      original message (`gnus-summary-reply-with-original').  This
  1423.      command uses the process/prefix convention.
  1424.  
  1425. `S w'
  1426.      Mail a wide reply to the author of the current article
  1427.      (`gnus-summary-wide-reply').  A "wide reply" is a reply that goes
  1428.      out to all people listed in the `To', `From' (or `Reply-to') and
  1429.      `Cc' headers.
  1430.  
  1431. `S W'
  1432.      Mail a wide reply to the current article and include the original
  1433.      message (`gnus-summary-reply-with-original').  This command uses
  1434.      the process/prefix convention.
  1435.  
  1436. `S o m'
  1437.      Forward the current article to some other person
  1438.      (`gnus-summary-mail-forward').  If given a prefix, include the full
  1439.      headers of the forwarded article.
  1440.  
  1441. `S m'
  1442. `m'
  1443.      Send a mail to some other person
  1444.      (`gnus-summary-mail-other-window').
  1445.  
  1446. `S D b'
  1447.      If you have sent a mail, but the mail was bounced back to you for
  1448.      some reason (wrong address, transient failure), you can use this
  1449.      command to resend that bounced mail
  1450.      (`gnus-summary-resend-bounced-mail').  You will be popped into a
  1451.      mail buffer where you can edit the headers before sending the mail
  1452.      off again.  If you give a prefix to this command, and the bounced
  1453.      mail is a reply to some other mail, Gnus will try to fetch that
  1454.      mail and display it for easy perusal of its headers.  This might
  1455.      very well fail, though.
  1456.  
  1457. `S D r'
  1458.      Not to be confused with the previous command,
  1459.      `gnus-summary-resend-message' will prompt you for an address to
  1460.      send the current message off to, and then send it to that place.
  1461.      The headers of the message won't be altered--but lots of headers
  1462.      that say `Resent-To', `Resent-From' and so on will be added.  This
  1463.      means that you actually send a mail to someone that has a `To'
  1464.      header that (probably) points to yourself.  This will confuse
  1465.      people.  So, natcherly you'll only do that if you're really eVIl.
  1466.  
  1467.      This command is mainly used if you have several accounts and want
  1468.      to ship a mail to a different account of yours.  (If you're both
  1469.      `root' and `postmaster' and get a mail for `postmaster' to the
  1470.      `root' account, you may want to resend it to `postmaster'.
  1471.      Ordnung muâ–€ sein!
  1472.  
  1473.      This command understands the process/prefix convention (*note
  1474.      Process/Prefix::.).
  1475.  
  1476. `S O m'
  1477.      Digest the current series and forward the result using mail
  1478.      (`gnus-uu-digest-mail-forward').  This command uses the
  1479.      process/prefix convention (*note Process/Prefix::.).
  1480.  
  1481. `S M-c'
  1482.      Send a complaint about excessive crossposting to the author of the
  1483.      current article (`gnus-summary-mail-crosspost-complaint').
  1484.  
  1485.      This command is provided as a way to fight back agains the current
  1486.      crossposting pandemic that's sweeping Usenet.  It will compose a
  1487.      reply using the `gnus-crosspost-complaint' variable as a preamble.
  1488.      This command understands the process/prefix convention (*note
  1489.      Process/Prefix::.) and will prompt you before sending each mail.
  1490.  
  1491.